INTRODUCTION :
-------------

Kprobes enables user to dynamically break into any kernel routine and collect
debugging and performance information non-disruptively. Kprobes is a mechanism
used to register breakpoints and corresponding handlers. After enabling Kprobes
support in the kernel, any instruction at any kernel address other than branch
and jump instructions can be debugged.

THE PACKAGE "kprobes-mips-patches-2.6.16.24.tgz" CONTENTS :
--------------------------------------------------

1. README
2. PATCHES
3. USER_TEST_PROGRAM
4. mips_kprobes_test_procedure.txt

1. README  : This gives the contents of the kprobes-mips-patches-2.6.16.24.tgz package
   release.

2. PATCHES : This directory contains the patches to the linux-kernel 2.6.16.24

   2.1. The following patches needs to be applied to boot the RBTX4927 board.

	URL:http://www.linux-mips.org/archives/linux-mips/2006-04/msg00034.html
	URL:http://www.linux-mips.org/archives/linux-mips/2006-04/msg00032.html
	URL:http://www.linux-mips.org/archives/linux-mips/2006-04/msg00031.html

   2.2. The following patches needs to be applied to enable the kprobes support
	These patches are present in the diectory 
	"PATCHES/KERNEL-KPROBE-PATCH/".

    i.	kprobes-mips-2.6.16.24-fixup.patch 

	Add Exceptions Notifier for MIPS.
	This patch provides notifiers for MIPS architecture exceptions.

    ii.	kprobes-mips-2.6.16.24-1.patch
	
	This patch is to add Kprobes support for MIPS.

   2.3. The following patches needs to be applied to enable the kprobes test 
	modules support.
	These patches are present in the diectory 
	"PATCHES/KERNEL-TESTCASE-PATCH".

    i.	kprobes-kernel-test-module.patch

	Kernel Probes test modules

	This patch provides Kprobes test modules to test Kprobes support.
	These kernel module will hook the user defined pre handler, post
	handler and fault handler to the probed point.

	This also provides documentation for kprobes test modules.


3. USER_TEST_PROGRAM : This contains the user space programs to test the Kprobes
	support.

4. mips_kprobes_test_procedure.txt : This gives the Kprobes test procedure for 
	both user space programs and kernel modules.
